在昨天的介紹的客製化網路路由一文提到，當網站伺服器收到請求，將此請求傳遞給 WordPress 解析完網址之後，會將生成 SQL 查詢語句，向 MySQL 資料庫查詢，接著取得資料後並生成內容輸出到網頁上。

圖：生成內容流程圖

而今天要介紹的主角就是 WP_Query 類別，它 WordPress 核心中，負責生成 SQL 查詢語句的組件。

圖：WP_Query 實例化過程

它的實例化是在 wp-settings.php 檔案中，大約 516 行位置，並將此實例放在全域變數 $wp_the_query 和 $wp_query 中。

以主要鉤點的生命週期來說，位於 sanitize_comment_cookies 和 setup_theme 之間。因此我們除了可以在佈景主題中直接使用 $wp_query 這個全域變數，在 setup_theme 之後的鉤點也可以使用。

使用時機

適合使用 WP_Query 的情境有兩種。

(1) 判斷請求頁面

要找出 WordPress目前正在處理的是哪一種請求，非常簡單，因為 WP_Query 類別中的 $is_ 屬性就是設計來存放這個資訊的，並在這裡使用條件標籤來互動。對外掛的開發者來說非常有用。

屬性

以下是部分屬性的例子：

• $is_single：如果當前請求是查看單一文章頁面，此屬性為 true。
• $is_page：如果當前是一個靜態頁面的請求，此屬性為 true。
• $is_archive：如果當前請求是一個彙整頁面，例如分類、標籤、作者等存檔頁面，此屬性為 true。

條件標籤函式

條件標籤指的是 WordPress 提供的一套函式，這些函數可以用來檢查當前請求的各種條件，並基於這些條件執行不同的程式邏輯。條件標籤和 WP_Query 實例的 $is_ 屬性直接相關，並提供了一個更簡潔、更方便的方式來進行檢查。

以下是部分條件標籤函式的例子：

• is_single()：檢查當前是否為單一文章頁面。
• is_page()：檢查當前是否為一個靜態頁面。
• is_archive()：檢查當前是否為一個彙整頁面。

(2) The Loop (迴圈)

The Loop 用在佈景主題的範本檔案中，WP_Query 提供了許多的方法來完成 The Loop 內的常見功能，例如：

if ( $the_query->have_posts() ) {
    while ( $the_query->have_posts() ) {
        $the_query->the_post();
        // 在這之後使用內容輸出的相關函式
    }
}

先使用 have_posts 方法來判斷是否有文章資料，如果有，就開始一個 while 迴圈，同樣使用 have_posts 作為條件，當所有文章在迴圈中被處理過（即指針移動到了最後一個文章之後的位置）， have_posts 會返回 false，結束 while 迴圈。

在每次迴圈中，呼叫 the_post 方法，它會設定全域變數 $post 讓其它依賴這個全域變數的函式可以使用。

WP_Query

參數

建構子的參位為陣列，根據查詢種類的不同有不一樣的條件，按此查詢。

屬性

通用類

可直接使用公開的屬性，例如 $queries = $wp_query->query_vars。

狀態類

狀態類的屬性對應了狀態標籤函式，例如 $is_single 對應到 is_single()。

方法

通用方法

狀態標籤方法

WP_Query 類別中的這些方法又被包裝為全域的函式方便呼叫。

使用範例

$args = array(
    'post_type' => 'post',
    'posts_per_page' => 5
);
$the_query = new WP_Query( $args );

這段簡短的程式碼，正是 WP_Query 類別的基本應用。$args 為查詢的條件。以這個例子來說，文章類型為 post，每頁筆數為 5。以此條件實例化後的 $the_query 即可在佈景主題中使用。

圖：鐵人賽相關文章程式範例

比較複雜一點的應用，例如要在文章頁面底下加上一個「鐵人賽相關文章」區塊，程式碼大概如上圖所示。

第 1 行：狀態標簽函式，判斷是否為單一文章頁面。
第 4 行至第 7 行：給 WP_Query 的查詢參數，找的是文章類型，顯示 5 筆。
第 9 行：實例化 WP_Query 類別。
第 14 行：更新文章所需的全域變數。
第 11 行至第 22 行：執行 The Loop，印出帶有文章連結的文章標題。

總結

WP_Query 類別主要用在佈景主題範本中，用於生成 SQL 查詢語句，並提供我們專門處理文章迴圈的方法，比較要注意的是 The Loop 的概念比較不直覺，它是採用在迴圈的區域內依次更新全域變數，接著依賴這些全域變數的函式才能正確輸出當前在迴圈中的文章，一開始如果不大習慣這樣的邏輯，多用幾次就習慣了。

課後思考：

WP_Query 類別提供了豐富的參數來查詢對應的資料表，但有些參數可能會產生不佳的 SQL 語句查詢，產生效能的問題，該如何避免這種情況發生？

前篇解答參考：

當發現 MySQL 的 binlog 長大的速度異常，或者 CPU 的負荷一直很高，就是一種警訊。使用像是 Query Monitor 這類的開發者工具，會將每一條 SQL 語句都列出來，當發現更新的對象為資料表 wp_options 的 rewrite_rules 欄位，就必須清查網站上的外掛，搜尋 flush_rewrite_rules 關鍵字。